home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / ab20_archive / languages / assembly / powervisor_113.lzh / docs / Aliases next >
Text File  |  1992-02-06  |  8KB  |  306 lines
  1. *--------------------*
  2. * Reference: Aliases * Thu Feb  6 15:47:25 1992
  3. *--------------------*
  4.  
  5.  
  6. ============================== Introduction ==================================
  7.  
  8. This reference file contains all aliases defined in s/PowerVisor-startup
  9. and s/pv/ExtraAliases.
  10.  
  11. =================================== why ======================================
  12.  
  13.    WHY
  14.  
  15.  
  16. Definition : help e\(error)
  17. Defined in : s/PowerVisor-startup
  18.  
  19. This alias gives some additional help for the last error.
  20.  
  21.  
  22. Related commands: help
  23.  
  24. =================================== lfd ======================================
  25.  
  26.    LFD <library name>
  27.  
  28.  
  29. Definition : loadfd [] fd:[]_lib.fd
  30. Defined in : s/PowerVisor-startup
  31.  
  32. This alias loads a ¹fd-file for a library. It is simply a shorthand
  33. notation.
  34.  
  35.  
  36. Example :
  37.  
  38. < lfd exec <enter>
  39.  
  40. instead of
  41.  
  42. < loadfd exec fd:exec_lib.fd <enter>
  43.  
  44.  
  45. Related commands: loadfd
  46.  
  47. =================================== bin ======================================
  48.  
  49.    BIN <number>
  50.  
  51.  
  52. Definition : bin  = {bin8 ([])>>8;bin8 ([]);print \0a}
  53.              bin8 = print \(([])>>7&1)\(([])>>6&1)\(([])>>5&1)\(([])>>4&1)
  54.                     \(([])>>3&1)\(([])>>2&1)\(([])>>1&1)\(([])&1)
  55. Defined in : s/PowerVisor-startup
  56.  
  57. This alias shows the binary representation of the 16 least significant
  58. bits of <number>.
  59.  
  60.  
  61. Example :
  62.  
  63. < bin 1234 <enter>
  64. > 0000010011010010
  65.  
  66. =================================== cmd ======================================
  67.  
  68.    CMD <cli command line>
  69.  
  70.  
  71. Definition : {rc="[]";rx s:pv/cmd}
  72. Defined in : s/PowerVisor-startup
  73.  
  74. You can use this alias to execute Cli commands from within PowerVisor.
  75. The output will appear on the default logical window. This alias uses
  76. a unique temporary file in 'T:'.
  77. Warning! You can't use Cli commands that ask for input.
  78.  
  79.  
  80. Example :
  81.  
  82. < cmd dir dh0: all <enter>
  83. > ...
  84.  
  85. =================================== asm ======================================
  86.  
  87.    ASM <address>
  88.  
  89. Definition : {rc=[];rx s:pv/assem}
  90. Defined in : s/PowerVisor-startup
  91.  
  92. This alias calls a simple assembler written in ARexx. See s:pv/assem.pv for
  93. more info about the assembler. Stop the assembler with an empty input line.
  94.  
  95. ================================= mstack =====================================
  96.  
  97.    MSTACK <task> <microseconds>
  98.  
  99.  
  100. Definition : {rwin 1;r 5 {home;d getstack()};stack []}
  101. Defined in : s/PowerVisor-startup
  102.  
  103. This alias is equivalent to the 'stack' command. The difference is that
  104. this alias first opens the ³refresh logical window with one visible line and
  105. installs a ²refresh command to display the maximum stack usage two times
  106. per second (5 ¹IntuiTicks).
  107.  
  108.  
  109. Example :
  110.  
  111. < mstack workbench 10000 <enter>
  112.  
  113.  
  114. Related commands: stack refresh
  115.  
  116. Related functions: getstack
  117.  
  118. =================================== at =======================================
  119.  
  120.    AT <command string> <code string> <qualifier string>
  121.  
  122.  
  123. Definition : attach [1] co([2]) qu([3]) e
  124. Defined in : s/PowerVisor-startup
  125.  
  126. This alias ¹attaches a command to a key (makes a macro). The advantage of
  127. this alias is that you can use names for the ¹code and ¹qualifier of the
  128. key instead of numbers.
  129.  
  130. Note that you have to define the 'co' and 'qu' functions in order to
  131. use this alias (this is already done in s/PowerVisor-startup).
  132.  
  133. Note that the 'co' function does not work perfectly in ²AmigaDOS 1.3. Only
  134. use the 'co' function (and thus the 'at' alias) for special keys
  135. ('enter', 'esc', 'up', ...) and not for normal keys ('a', '3', ...).
  136.  
  137. The following code strings are supported :
  138.  
  139.    f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, esc, enter, ret, up, down,
  140.    right, left, del, help, tab, numl, scrl, prtsc, home, end, nup, nleft,
  141.    nright, ndown, pgup, pgdn, ins, ndel
  142.  
  143.    All other strings are interpreted as one char only (you may only use one
  144.    of the above strings if you have AmigaDOS 1.3)
  145.  
  146. The following qualifier strings are supported :
  147.  
  148.    lshift, rshift, ctrl, lalt, ralt, lcmd, rcmd
  149.  
  150.  
  151. Example :
  152.  
  153. < at 'help commands' help ralt <enter>
  154.  
  155. This command attaches the 'help commands' command to the <right-alt>+<help>
  156. key.
  157.  
  158.  
  159. Related commands: attach remattach
  160.  
  161. ================================== opwin =====================================
  162.  
  163.    OPWIN <window name>
  164.  
  165.  
  166. Definition : {-openpw [] 0 0 300 200;-openlw [] [] 80 40}
  167. Defined in : s/PowerVisor-startup
  168.  
  169. This alias opens a ²physical window <window name> with size 300x200
  170. and opens a ²logical window with the same name in this physical window.
  171.  
  172.  
  173. Related commands: openpw openlw
  174.  
  175. ================================== fact ======================================
  176.  
  177.    FACT <number>
  178.  
  179.  
  180. Definition : fact  = disp {_fact []}
  181.              _fact = void if(([])==1,1,{_fact ([])-1}*([]))
  182. Defined in : s/pv/ExtraAliases
  183.  
  184. This alias computes the facultaty of its argument. It is an example of
  185. how to use ²recursive aliases.
  186.  
  187.  
  188. Example :
  189.  
  190. < fact 5 <enter>
  191. > 00000078 , 120
  192.  
  193.  
  194. Related commands: disp void
  195.  
  196. Related functions: if
  197.  
  198. ================================= fdebug =====================================
  199.  
  200.    FDEBUG
  201.  
  202.  
  203. Definition : script db
  204. Defined in : s/PowerVisor-startup
  205.  
  206. This alias installs the ²fullscreen debugger for you. If the debug logical
  207. window is not open it is opened ('dwin' command). The number of instructions
  208. in the disassembly is set to 5 ('prefs debug' command). Some keys are
  209. assigned to commands (<lcmd> is left amiga key) :
  210.  
  211.    <ctrl>+z       ³singlestep one instruction
  212.    <ctrl>+y       singlestep one instruction
  213.    <ctrl>+a       ²set breakpoint after this instruction and execute
  214.    <ctrl>+s       ³skip current instruction
  215.    <ctrl>+r       ²run program until a breakpoint hit occurs
  216.    <ctrl>+x       ³halt running program
  217.    <ctrl>+b       set/reset a temporary breakpoint at the top of the
  218.                   ³debug logical window
  219.    <ctrl>+t       singlestep but ²skip BSR and JSR instructions
  220.    <lcmd>+u       ²trace until ...
  221.    <lcmd>+b       trace until a ³change of programflow occurs (branch, ...)
  222.    <rcmd>+a       set debug window start address ...
  223.    <rcmd>+b       set ²permanent breakpoint ...
  224.  
  225. Note that these keys can differ when you use another ²default keymap (like
  226. 'azerty' or 'qwertz'). Change the 'db' script if you want to use other keys.
  227.  
  228. 'fdebug' redefines itself. After the fullscreen debugger is installed you
  229. can use 'fdebug' to remove the fullscreen debugger. 'fdebug' is a toggle.
  230.  
  231. Note that the 'db' script (located in s/pv) works best when called
  232. from within the alias. Never execute this script directly.
  233.  
  234.  
  235. Related commands: debug trace break
  236.  
  237. ================================= salias =====================================
  238.  
  239.    SALIAS <commandline>
  240.  
  241.  
  242. Definition : {print \({_fl={pv 48 ·Å[]Å}},%s)\0a;v free(_fl);remvar _fl}
  243. Defined in : s/PowerVisor-startup
  244.  
  245. With this alias you can show the commandline how it would look like
  246. after ²alias substitution. This is very useful for ²debugging aliases.
  247. If an alias does not work well you can use this alias to see what
  248. actually gets executed.
  249.  
  250.  
  251. Example :
  252.  
  253. < alias x '[3][2][1] testing []' <enter>
  254. < salias x i r p last <enter>
  255. > pri testing i r p last
  256.  
  257.  
  258. Related commands: print pvcall
  259.  
  260. =================================== cu =======================================
  261.  
  262.    CU [<number of lines>]
  263.  
  264.  
  265. Definition : u lastmem() []
  266. Defined in : s/PowerVisor-startup
  267.  
  268. This alias is equivalent to the 'unasm' command. The only difference is that
  269. you can specify the number of lines to disassemble without having to specify
  270. the starting address.
  271.  
  272.  
  273. Related commands: unasm
  274.  
  275. =================================== cm =======================================
  276.  
  277.    CM [<number of bytes>]
  278.  
  279.  
  280. Definition : m lastmem() []
  281. Defined in : s/PowerVisor-startup
  282.  
  283. This alias is equivalent to the 'memory' command. The only difference is that
  284. you can specify the number of bytes to view without having to specify
  285. the starting address.
  286.  
  287.  
  288. Related commands: memory
  289.  
  290. =================================== vu =======================================
  291.  
  292.    VU [<number of bytes>]
  293.  
  294.  
  295. Definition : view lastmem() []
  296. Defined in : s/PowerVisor-startup
  297.  
  298. This alias is equivalent to the 'view' command. The only difference is that
  299. you can specify the number of bytes to view without having to specify
  300. the starting address.
  301.  
  302.  
  303. Related commands: view
  304.  
  305.  
  306.